home *** CD-ROM | disk | FTP | other *** search
/ Grand Slam 3 / Grand Slam 3.iso / 002 / a2mnu020.arj / ANSI2MNU.DOC next >
Text File  |  1995-06-06  |  9KB  |  182 lines
  1. SOFTWARE : ANSI2MNU
  2.  
  3. VERSION : 0.2
  4.  
  5. PURPOSE : Converting a ANSI file and a seperate command-file into a
  6.           RemoteAcces 2.0x MNU-file.
  7.  
  8. LIMITATIONS : Only one file at the time from hardcoded file-names.
  9.           No interpretation of the codes.
  10.           All files must be in the same directory.
  11.  
  12. WARRENTY : None, due to the fact that it is FREEWARE.
  13.            It works at my place, if that means anything to you.
  14.  
  15. SYNTAX : ANSI2MNU [path\]<file-name>
  16.  
  17. FUNCTION : This software will read two files (*.DIS & *.CMD) and will
  18.            create a typical RemoteAccess 2.0x menu file (*.MNU).
  19.  
  20.        A display file (*.DIS) is a file which may have AVT, ANSI and/or
  21.        Ra-Codes in it or just plain ASCII. You may also use ^ and other
  22.        typical RA-Menu codes, as long as the rows are smaller than 135
  23.        characters.
  24.  
  25.        The command-file (*.CMD) holds some basic data. This file is
  26.        bounded by a view rules:
  27.        1) Data must be seperated with a space.
  28.        2) The syntax-structure of the first line is:
  29.               [<HighlightedColor> [<PromptColor> [<Prompt>]]]
  30.               If a color is left out, 0 will be used. If prompt is left out
  31.               an empty prompt will be used.
  32.        3) Every next line must have the structure:
  33.               <MenuCommand> [<Option>]
  34.            4) Options start with a /, between the indentification and the
  35.               data a = and end with a <space> or <end-of-line>.
  36.               Example: /FGC=15 /BGC=16 (blinking white on black)
  37.            5) The last option in the list, if present, must be MIS.
  38.  
  39.               <MenuCommand> may be any valid RA 2.0x menu-command-number.
  40.                             0 for a simple display.
  41.               <Option>      holds the data which differs from a default.
  42.                             All possible flags and limitations are
  43.                             supported.
  44.  
  45.   Option    Description                  Values
  46.   --------- ----------------------------
  47.   SEC       Minumum Security Level       0 .. 65535
  48.   MSC       Maximum Security Level       0 .. 65535
  49.   NF1..NF4  NotFlagsMask { o }           0 .. 255   BitMapped : 1..4 = A..D
  50.                                                     Bit 0 : o------- = A1
  51.                                                     Bit 1 : -o------ = A2
  52.                                                     Bit 2 : --o----- = A3
  53.                                                     Bit 3 : ---o---- = A4
  54.                                                     Bit 4 : ----o--- = A5
  55.                                                     Bit 5 : -----o-- = A6
  56.                                                     Bit 6 : ------o- = A7
  57.                                                     Bit 7 : -------o = A8
  58.   FL1..FL4  FlagsMask    { x }           0 .. 255   BitMapped : 1..4 = A..D
  59.                                                     Bit 0 : x------- = A1
  60.                                                     Bit 1 : -x------ = A2
  61.                                                     Bit 2 : --x----- = A3
  62.                                                     Bit 3 : ---x---- = A4
  63.                                                     Bit 4 : ----x--- = A5
  64.                                                     Bit 5 : -----x-- = A6
  65.                                                     Bit 6 : ------x- = A7
  66.                                                     Bit 7 : -------x = A8
  67.   TLF       Minimum Time Left (Minutes)  0 .. 65535
  68.   TUS       Minimum Time Used (Minutes)  0 .. 65535
  69.   AGE       Minimum Age                  0 .. 255
  70.   TER       Terminal Attribute           0 .. 255   BitMapped
  71.                                                     Bit 0 : ANSI
  72.                                                     Bit 1 : AVT
  73.                                                     Bit 2 : RIP
  74.   SPE       Minimum Speed (BPS)          0 .. 4228250625
  75.   MSP       Maximum Speed (BPS)          0 .. 4228250625
  76.   CRE       Minimum Credits Left         0 .. 4228250625
  77.   COS       Option Cost                  0 .. 4228250625
  78.   MNC       Cost Per Minute              0 .. 4228250625
  79.   N1..N32   Node                         0 .. 255   BitMapped :
  80.             N1 Bit 0 : Node 0 (Local)    N2 Bit 0 : Node 8
  81.             N1 Bit 1 : Node 1            N2 Bit 1 : Node 9
  82.             N1 Bit 2 : Node 2            N2 Bit 2 : Node 10
  83.             N1 Bit 3 : Node 3            N2 Bit 3 : Node 11
  84.             N1 Bit 4 : Node 4            N2 Bit 4 : Node 12
  85.             N1 Bit 5 : Node 5            N2 Bit 5 : Node 13
  86.             N1 Bit 6 : Node 6            N2 Bit 6 : Node 14
  87.             N1 Bit 7 : Node 7            N2 Bit 7 : Node 15   etc.
  88.   G1..G32   Group                        0 .. 255   BitMapped :
  89.             G1 Bit 0 : Node 0 (Local)    G2 Bit 0 : Group 8
  90.             G1 Bit 1 : Group 1           G2 Bit 1 : Group 9
  91.             G1 Bit 2 : Group 2           G2 Bit 2 : Group 10
  92.             G1 Bit 3 : Group 3           G2 Bit 3 : Group 11
  93.             G1 Bit 4 : Group 4           G2 Bit 4 : Group 12
  94.             G1 Bit 5 : Group 5           G2 Bit 5 : Group 13
  95.             G1 Bit 6 : Group 6           G2 Bit 6 : Group 14
  96.             G1 Bit 7 : Group 7           G2 Bit 7 : Group 15   etc.
  97.   ST1..ST7  StartTime (Minutes)          0 .. 1439 : 1..7 = Sunday - Saterday
  98.   ET1..ET7  StopTime (Minutes)           0 .. 1439 : 1..7 = Sunday - Saterday
  99.   HOT       HotKey                       #1..#255
  100.   MIS       MiscData                     StringLength <= 135 Characters
  101.   FGC       Foreground                   0 .. 15 : Formatted : ----Hfff
  102.                                          H   for Highlighted
  103.                                          fff for  0 Black / Dark Gray
  104.                                                   1 Blue / Light Blue
  105.                                                   2 Green / Light Green
  106.                                                   3 Cyan / Light Cyan
  107.                                                   4 Red / Orange
  108.                                                   5 Magenta / Light Magenta
  109.                                                   6 Brown / Yellow
  110.                                                   7 Gray / White
  111.   BGC       Background                   0 .. 15 : Formatted : ----Bfff
  112.                                          H   for Blink
  113.                                          fff for  0 Black
  114.                                                   1 Blue
  115.                                                   2 Green
  116.                                                   3 Cyan
  117.                                                   4 Red
  118.                                                   5 Magenta
  119.                                                   6 Brown
  120.                                                   7 Gray
  121.  
  122. EXAMPLES :  In these 2 examples the ^ is a literal ^ and not a sign to
  123.             indecate a control-code as you will find in many other documents.
  124.  
  125.             test.DIS:
  126.         ---------------- TEST MENU ----------------
  127.                 ^A^) Option A              ^B^) Option B
  128.         -------------------------------------------
  129.                 ^-^) Return                Time Left : ^~^
  130.         -------------------------------------------
  131.  
  132.             test.CMD
  133.                 15 0 Keuze :
  134.                 1 /FGC=13 /HOT=A /MIS=Menua /ns
  135.                 1 /FGC=14 /HOT=B /MIS=menub
  136.                 1 /FGC=13 /HOT=- /MIS=main
  137.                 0 /FGC=14
  138.                 0 /FGC=13
  139.  
  140.             This was an example of a simple non-synchronised menu.
  141.             Next example will show the same menu, but synchronized, just
  142.             like it has been decompiled with MNU2ANSI.
  143.  
  144.             test.DIS:
  145.                 ---------------- TEST MENU ----------------
  146.                 ^A^) Option A              ;
  147.                 ^B^) Option B
  148.         -------------------------------------------
  149.                 ^-^) Return                Time Left : ^~^
  150.         -------------------------------------------
  151.  
  152.             test.CMD
  153.                 15 0 Keuze :
  154.                 0 /FGC=13
  155.                 1 /FGC=14 /HOT=A /MIS=Menua /ns
  156.                 1 /FGC=14 /HOT=B /MIS=menub
  157.                 0 /FGC=13
  158.                 1 /FGC=14 /HOT=- /MIS=main
  159.                 0 /FGC=13
  160.  
  161. HISTORY : Initial release: version 0.1
  162.           ■ Never hatched or make any effort to pass it through a network.
  163.  
  164.           Second release: version 0.2
  165.           ■ First official release.
  166.  
  167. AUTHEUR : Contact me for bug-reports and sugestions:
  168.  
  169.           SnailMail: Gert de Vente
  170.                      Hakfort 352
  171.                      1102 LA Amsterdam
  172.                      Netherlands
  173.  
  174.           NetMail:   2:280/805 @ fidonet.org
  175.                      73:7310/10 @ ranet.org
  176.                      206:206/6 @ disaster.org
  177.  
  178. COPYRIGHTED : All mentioned software (ANSI2MNU, MNU2ANSI) and this document
  179.               may not be altered without my knowledge.
  180.  
  181.               Go$oƒt (Gert de Vente) is a member of VNSP: 950521/01/M
  182.